AI 說「程式已完成」,可能只是檔案寫好了。能不能執行、輸入錯誤時會不會給提示,還需要自己確認。
程式內部測試有價值,但使用者是透過命令入口操作。今天的成功條件很小:能看到繁中說明,未知參數會報錯,兩種啟動方式一致。
依 docs/PROJECT-BRIEF.md 建立 Python package research_workbench。
今天只做 argparse CLI 的 --help 與 --version。
在 pyproject.toml 定義 research console script,
並提供 python -m research_workbench 的等價入口。
暫不加 init、scan 或任何資料庫/網路動作。
使用標準庫,說明各檔案職責並執行最小入口測試。
PowerShell:
.\.venv\Scripts\python.exe -m pip install -e .
.\.venv\Scripts\research.exe --help
.\.venv\Scripts\python.exe -m research_workbench --help
.\.venv\Scripts\research.exe --unknown
$LASTEXITCODE
第三個呼叫應回報未知參數,不能默默當成成功。
如果版本提供 /run、/verify,選擇本 CLI 作為目標,觀察它是否真的執行命令。沒有這些 skills 仍可照上面手動核對;原生 skill 實測項保持未通過或不適用。Skills 的執行與驗證能力
pytest 通過,但 research 找不到。檢查是否安裝到本專案 .venv,以及 pyproject.toml 的入口是否指向正確函式。不要把「能 import」當成「命令可使用」。
實測後補:三段輸出、入口檔位置,以及 AI 的驗收是否遺漏任何一步。
明天把整理研究問題的流程,寫成自己的第一個 Skill。